Customer Order Delivery

Frequency:

Customer order delivery data is available when the delivery process closes on the WMS side.

Expected data:

Returns delivery data for a given Customer Order (CO).

Technical:

---

GET https://{url}/v1/orders/customer/{customerOrderExternalId}/delivery

Retrieve delivery data for a customer order.

Response Body

The response contains customer order header fields and a pickings array. Each picking contains a details array with the picked line items.

Top-level response fields:

Name	Type	Required	Description
success	boolean	Yes	Whether the operation succeeded
message	string	No	Error message, if applicable
customer_order_id	string	Yes	CO unique identifier in ERP
status	integer	Yes	CO delivery status: 1 - Not started, 2 - In picking, 3 - Delivered
shipping_date	string	Yes	CO delivery date (in format '2025-04-15T12:51:34')
delivery_document_id	string	Yes	Delivery document unique identifier in WMS
pickings	array	Yes	Array of picking document objects

Picking object (inside pickings array):

Name	Type	Required	Description
picking_document_id	string	Yes	Picking document unique identifier in WMS
picking_date	string	Yes	Picking document date (in format '2025-04-15T12:51:34')
details	array	Yes	Array of detail line objects for the picking document

Detail object (inside details array):

Name	Type	Required	Description
customer_order_line_number	integer	Yes	CO detail line number
source_customer_order_line_number	integer	Conditional	Source CO detail line number
article_id	string	Yes	Article unique identifier in ERP
quantity	number	Yes	Picked quantity
quantity_unit_id	string	Yes	Picked quantity unit of measure
excise	object	Conditional	Excise stamp data object (contains serial, range_from, range_to). Present for tobacco or alcohol articles.
shelf_lives	string[]	No	List of shelf life dates (in format '2021-02-04T00:00:00')
local_excise	string	No	Local excise stamp information
country_of_origin	string	No	Country of origin from picked stock

Response

200: OK — Success

{
    "success": true,
    "message": null,
    "customer_order_id": "3000437294",
    "status": 3,
    "shipping_date": "2025-04-15T12:51:34",
    "delivery_document_id": "8726834",
    "pickings": [
        {
            "picking_document_id": "WMS992827",
            "picking_date": "2025-04-15T12:51:34",
            "details": [
                {
                    "customer_order_line_number": 10000,
                    "article_id": "0001",
                    "quantity": 12,
                    "quantity_unit_id": "PCS",
                    "country_of_origin": "KR",
                    "shelf_lives": [
                        "2021-02-04T00:00:00"
                    ]
                },
                {
                    "customer_order_line_number": 10500,
                    "source_customer_order_line_number": 10000,
                    "article_id": "0001",
                    "quantity": 12,
                    "quantity_unit_id": "PCS",
                    "country_of_origin": "JP",
                    "shelf_lives": [
                        "2021-02-04T00:00:00"
                    ]
                },
                {
                    "customer_order_line_number": 11000,
                    "source_customer_order_line_number": 10000,
                    "article_id": "0001",
                    "quantity": 36,
                    "quantity_unit_id": "PCS",
                    "country_of_origin": "JP",
                    "shelf_lives": [
                        "2021-02-11T00:00:00",
                        "2022-02-25T00:00:00"
                    ]
                }
            ]
        },
        {
            "picking_document_id": "WMS992979",
            "picking_date": "2025-04-15T12:51:34",
            "details": [
                {
                    "customer_order_line_number": 10000,
                    "article_id": "0001",
                    "quantity": 24,
                    "quantity_unit_id": "PCS",
                    "shelf_lives": [
                        "2021-02-04T00:00:00"
                    ]
                },
                {
                    "customer_order_line_number": 20000,
                    "article_id": "0047",
                    "quantity": 18,
                    "quantity_unit_id": "PCS",
                    "excise": {
                        "serial": "GF",
                        "range_from": 1500,
                        "range_to": 3000
                    },
                    "shelf_lives": [
                        "2021-02-04T00:00:00"
                    ]
                },
                {
                    "customer_order_line_number": 20500,
                    "source_customer_order_line_number": 20000,
                    "article_id": "0047",
                    "quantity": 12,
                    "quantity_unit_id": "PCS",
                    "excise": {
                        "serial": "GM",
                        "range_from": 400,
                        "range_to": 500
                    },
                    "shelf_lives": [
                        "2021-02-04T00:00:00",
                        "2022-02-25T00:00:00"
                    ]
                }
            ]
        }
    ]
}

400: Bad Request — Error

{
    "success": false,
    "message": "Customer Order not found"
}